home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_util / fsync11b.zip / FILESYNC.DOC < prev    next >
Text File  |  1996-04-01  |  4KB  |  116 lines
  1.                              FileSync 1.1b
  2.          Copyright (c) 1995, James Morris. All rights reserved
  3.            Documentation by his trusty sidekick, John Bodoni
  4.  
  5.  
  6. : Summary :
  7.  
  8. FileSync removes files listed in FILES.BBS that aren't on your drive. It will
  9. also optionally create a TBBS psuedo-directory at the same time.
  10.  
  11. Nice touches include the option to add a header to the psuedo-directory and the
  12. ability to backup the original (non-mangled) FILES.BBS.
  13.  
  14. FileSync can be used by anyone that purges files that needs to keep a
  15. FILES.BBS-format file up to date after a file purge.
  16.  
  17. See Recommendations on a program to delete files based on date.
  18.  
  19. : Disclaimers :
  20.  
  21. #include Disclaim.Std
  22.  
  23. Besides all the usual disclaimers, FileSync is guaranteed to do nothing
  24. (besides take up disk space) until you run it. If you run it, it will probably
  25. work as expected and it will *still* take up disk space. 8)
  26.  
  27. If you use this program and it breaks your system, you own it all. 8)
  28.  
  29. See Recommendations about backing up your system.
  30.  
  31.  
  32. : Usage :
  33.  
  34. FILESYNC /S=SOURCE.BBS [/T=TBBS.DIR | /H=HEADER.FIL | /B]
  35.  
  36.    /S=       The source FILES.BBS format file. Required!
  37.    /T=       Optional TBBS .DIR file to generate.        ─┐
  38.    /H=       Optional Header file to add to the TBBS .Dir │
  39.    /D        Enable the inclusion of the filesize and date├─ Optional
  40.              in the TBBS .DIR file.                       │
  41.    /B        Enable the creation of backup files.        ─┘
  42.  
  43. These switches may be in any order. Nothing is case-sensitive. You can even use
  44. - instead of / if you prefer.
  45.  
  46. If you don't specify a directory in the /T and /H parms, FileSync will look in
  47. the directory that the source file is in. If /B is used, the backup file will
  48. be placed in the same directory as the source file.
  49.  
  50. Normal usage would be something like this:
  51.  
  52. FileSync /s=g:\ddsdoors\files.bbs /t=files.dir /h=about.txt /b
  53.  
  54. This command would create a TBBS psuedo-directory called files.dir in the
  55. g:\ddsdoors\ directory. The psuedo-directory would contain the contents of
  56. g:\ddsdoors\about.txt at the beginning of the file.
  57.  
  58. Presumably, about.txt would contain something like "Doors and Games". This
  59. method would allow you to have a different header for each download area
  60. describing the contents of the area.
  61.  
  62. A backup copy would be made of files.bbs called files.bb0 and placed in the
  63. g:\ddsdoors\ directory.
  64.  
  65. The newly created files.bbs (and optional tbbs.dir) will list only files that
  66. exist in the directory. If you deleted a file and didn't manually trim it from
  67. files.bbs, it's trimmed now.
  68.  
  69.  
  70. : Recommendations :
  71.  
  72. Back up everything as often as possible.
  73.  
  74. Question authority.
  75.  
  76. A good program that will delete files based on date is a jewel of a shareware
  77. program called EDel by Lawrence Martin. From the help:
  78.  
  79.   ┌─────────────────────────────────────────────────────────────────┐
  80.   │ With EDEL it is possible to remove all files (including hidden, │
  81.   │ system, and read-only) and directories on a disk or diskette    │
  82.   │ with one command. Files can be deleted based upon the the age   │
  83.   │ of the file. A preview of files which would be deleted can also │
  84.   │ be obtained.                                                    │
  85.   └─────────────────────────────────────────────────────────────────┘
  86.  
  87. It's simply the best for deciding which nodelist.??? to nuke. 8)
  88.  
  89. Another gem (freeware!) is Run@ by TapirSoft (Gisbert W.Selke). Get it. It's
  90. small and you'll probably find a use for it. From the help:
  91.  
  92.   ┌──────────────────────────────────────────────────────────────────┐
  93.   │ Reads a list of (e.g.,) file names from StdIn (one per line),    │
  94.   │ writes a batch file (default name RUN@@.BAT) which will execute  │
  95.   │ the command specified on Run@'s command line once for each file. │
  96.   └──────────────────────────────────────────────────────────────────┘
  97.  
  98.  
  99. : End :
  100.  
  101. James can be reached via netmail at 1:284/29 for bug reports or feature
  102. requests. (or a modest donation!).
  103.  
  104.  James Morris
  105.  P.O. Box 3150
  106.  Springfield, MO 65808-3150
  107.  
  108. John can be reached via netmail at 1:284/99, but I don't really know why you'd
  109. want to. Does your program need docs as obnoxious as these? 8)
  110.  
  111. If James gets more than ten bucks in donations for writing this program, he
  112. owes me a sixpack of Mountain Dew (Breakfast of Champions no matter WHAT it
  113. says on the Wheaties box!).
  114.  
  115. Of course, he doesn't *know* it yet... 8)
  116.